package com.mkx.domain.repository;

import com.mkx.domain.entity.User;

import java.util.List;
import java.util.Optional;

/**
 * 用户仓储接口
 * 定义用户实体的持久化操作
 */
public interface UserRepository {
    
    /**
     * 根据ID查找用户
     * @param id 用户ID
     * @return 用户实体，如果不存在则返回空
     */
    Optional<User> findById(String id);
    
    /**
     * 根据用户名查找用户
     * @param username 用户名
     * @return 用户实体，如果不存在则返回空
     */
    Optional<User> findByUsername(String username);
    
    /**
     * 根据邮箱查找用户
     * @param email 邮箱地址
     * @return 用户实体，如果不存在则返回空
     */
    Optional<User> findByEmail(String email);
    
    /**
     * 根据手机号查找用户
     * @param phone 手机号
     * @return 用户实体，如果不存在则返回空
     */
    Optional<User> findByPhone(String phone);
    
    /**
     * 保存用户（新增或更新）
     * @param user 用户实体
     * @return 保存后的用户实体
     */
    User save(User user);
    
    /**
     * 删除用户
     * @param id 用户ID
     * @return 是否删除成功
     */
    boolean deleteById(String id);
    
    /**
     * 批量查找用户
     * @param ids 用户ID列表
     * @return 用户实体列表
     */
    List<User> findByIds(List<String> ids);
    
    /**
     * 分页查询用户
     * @param page 页码（从1开始）
     * @param size 每页大小
     * @return 用户实体列表
     */
    List<User> findAll(int page, int size);
    
    /**
     * 统计用户总数
     * @return 用户总数
     */
    long count();
    
    /**
     * 检查用户名是否存在
     * @param username 用户名
     * @return 是否存在
     */
    boolean existsByUsername(String username);
    
    /**
     * 检查邮箱是否存在
     * @param email 邮箱地址
     * @return 是否存在
     */
    boolean existsByEmail(String email);
    
    /**
     * 检查手机号是否存在
     * @param phone 手机号
     * @return 是否存在
     */
    boolean existsByPhone(String phone);
}